Skip to content

Add Pip Support for android and ios#170

Merged
kdroidFilter merged 7 commits intokdroidFilter:masterfrom
dhiaspaner:master
Apr 10, 2026
Merged

Add Pip Support for android and ios#170
kdroidFilter merged 7 commits intokdroidFilter:masterfrom
dhiaspaner:master

Conversation

@dhiaspaner
Copy link
Copy Markdown
Contributor

@dhiaspaner dhiaspaner commented Feb 21, 2026 •
edited
Loading

PR: Feature - Picture-in-Picture (PiP) Support

📝 Description

This Pull Request introduces Picture-in-Picture (PiP) mode to the ComposeMediaPlayer library. This feature allows users to continue watching video content in a floating window while navigating away from the application on mobile devices.

📱 Supported Platforms

Platform Status Notes
Android ✅ Fully supported using native Android PiP APIs (requires Android 8.0+).
iOS ✅ Fully supported using AVPictureInPictureController.
Desktop ❌ Not supported (No-op).
Web ❌ Not supported (No-op).

🛠 Implementation Details

Common Code

  • Introduced a platform-agnostic interface to handle PiP requests.
  • Added logic to gracefully handle PiP triggers on unsupported platforms (no-op).

Android

  • Enabled android:supportsPictureInPicture="true" in the manifest.
  • Implemented something similar toonUserLeaveHint to automatically enter PiP mode when the user backgrounds the app while video is playing.
  • Configured PictureInPictureParams to handle aspect ratio updates dynamically based on the video content.

iOS

  • Integrated AVPictureInPictureController with the existing AVPlayer layer.
  • Handled the restoration of the user interface when returning from PiP mode.

🧪 How to Test

Android

  1. Launch the app and start playing a video.
  2. Press the Home button or swipe up to go home.
  3. Expectation: The app minimizes into a floating PiP window, and the video continues playing.
  4. Tap the PiP window to expand it back to full screen.

iOS

  1. Launch the app and start playing a video.
  2. Swipe up to go home or tap the PiP toggle button.
  3. Expectation: The video detaches into a floating overlay, and playback continues.
  4. Lock the screen and verify audio continues playing.

📸 Screenshots / Screen Recordings

(Please attach screenshots or a GIF/video of the PiP transition on Android and iOS here)

⚠️ Notes

  • Android: Min SDK is set to 23, but PiP requires API 26+. Checks are in place to ensure safety on older devices.
  • iOS: Requires "Audio, AirPlay, and Picture in Picture" to be enabled in the Background Modes capability.

@xephosbot
Copy link
Copy Markdown
Contributor

xephosbot commented Feb 25, 2026

Hi!
Are you sure that PiP functionality should be part of VideoPlayerState? In its current form, this might be a bit misleading, since PiP is only available on Android and iOS.
It might be cleaner to extract them into a separate entity - e.g. PictureInPictureController - and publish it as separate artifact with clear note that its supported only on Android and iOS.
A similar approach is used in my project, you can find the implementation here: PictureInPicture.kt

@dhiaspaner
Copy link
Copy Markdown
Contributor Author

dhiaspaner commented Feb 26, 2026 •
edited
Loading

@xephosbot Yes, I like your approach. I initially created the controller at the beginning, but since I inject it into the video player, that makes it unnecessary. However, injecting the player into the PiP controller would make more sense. Thanks for your comment 🙌

@kdroidFilter kdroidFilter merged commit 33201f2 into kdroidFilter:master Apr 10, 2026
@kdroidFilter
Copy link
Copy Markdown
Owner

kdroidFilter commented Apr 10, 2026

Thank you very much, sorry for the delay, but it's merged!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

No reviews

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

3 participants

@dhiaspaner @xephosbot @kdroidFilter